home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 2 / CD ACTUAL VOL 2.iso / docs / mini / tia < prev    next >
Encoding:
Text File  |  1995-09-10  |  11.6 KB  |  319 lines
  1. Global Linux-TIA HOWTO
  2.  
  3. version1.7G (updated 8/6/95) by Irish
  4.  
  5. This document will describe how to get your Linux box to connect to a
  6. generic site via TIA, The Internet Adaptor. I take no responsibility for
  7. your use of this information, but corrections are welcome. 
  8.  
  9. I will not attempt to describe all that can be done over this connection
  10. once established, but I will refer you to other documents or sites that
  11. will contain the relevant information. 
  12.  
  13. That done, let's do it!
  14.  
  15.  
  16.  
  17.    1.0 What is TIA? 
  18.  
  19.    The Intenet Adaptor was written by the fine folks at marketplace.com. It is
  20.    used to simulate a SLIP connection from a shell account. It costs $25 for a
  21.    single user license, site licenses are available. It works with any client 
  22.    OS that uses standard TCP/IP and SLIP networking, and clients. 
  23.  
  24.    1.1 How does TIA work?
  25.  
  26.    It is important to understand how TIA works in general, to be aware of its
  27.    limitations. First, you do not need to install TIA on your machine. It
  28.    runs on your remote host only. What you need is the TCP/IP and SLIP protocols
  29.    installed in your kernel (more on that in a bit), and some clients.
  30.  
  31.    Here's what happens: you send network requests from your machine to your
  32.    remote host over the SLIP link. TIA grabs them and sends them out to the Net
  33.    at large. Then, incoming data is sent back from the Net to your account on 
  34.    the remote host, where TIA grabs it and sends it back over the SLIP link to 
  35.    your machine. So, to the Net it appears as if you are working out of your 
  36.    account on the remote host, but to you it looks like you are really 
  37.    connected right to the Net.
  38.  
  39.    As you can see, this can confuse stuff that is incoming from the Net. For
  40.    example, talk doesn't work via TIA, because the incoming talk request 
  41.    tries to start the remote hosts talk daemon, not yours.
  42.  
  43.    The other big difference between TIA and real SLIP is you are NOT assigned
  44.    your own IP address; remember, you are only converting a dialup account to a
  45.    SLIP connection.
  46.  
  47.    1.2 What about Term?
  48.  
  49.    What about it? My opinion; Using Term is like using a crank to start your 
  50.    car, a lot of work and completely unnessesary. Of course, if you don't 
  51.    have root access to your machine for one reason or another, and you can't 
  52.    persuade someone who does to install SLIP and dip, then you won't have much 
  53.    choice. If you really want to know more about Term, read the HOWTO on 
  54.    Sunsite. 
  55.  
  56.    1.3 What about SLiRP?
  57.  
  58.    This is new, and it's free because it's GPLed. TIA isn't free, but it's 
  59.    real cheap, real stable, and well supported and documented. Go ahead and 
  60.    try it if you wish, but please don't mail me with questions , 'cause I 
  61.    just don't know anything about it. Don't get me wrong, obviously I have 
  62.    nothing against free software, but TIA is what I know and use. Besides, 
  63.    for me TIA is free, because the Admin here purchased a site license. 
  64.    Maybe you can convince yours, it's worth it, for you and them. 
  65.  
  66.  
  67. Enough already! How do I set it up?
  68.  
  69.    2.0 Preparing your Linux machine
  70.  
  71.    In a nutshell, here's what's required. I'll explain each of these in detail.
  72.  
  73.       -> Compile your kernel to include SLIP and TCP/IP 
  74.       -> Edit some files in /etc 
  75.       -> Install and configure dip 
  76.    You will also need to get the TIA binary appropriate for your remote host and
  77.    install it. All of the relevant info for this is available at TIAs home 
  78.    site. 
  79.  
  80.    NOTENOTENOTE: The BETA version of TIA 2.0 is out now. It supports,
  81.    among other things, CSLIP and PPP. There are very few changes required to
  82.    use CSLIP, and they are noted below. A PPP HOWTO will be forthcoming
  83.    soon, as well as documentation on some new features. Watch this space!
  84.  
  85. That's it! Let's get started.
  86.  
  87.    2.1 Compiling your kernel
  88.  
  89.    If you have never done this, you should. And you should read the FAQ 
  90.    first, but don't worry, it's easy. If you want, you can e-mail me and 
  91.    I'll help.
  92.  
  93.    I'll assume that you have here, for the sake of brevity. When you 'make 
  94.    config', look for "Network Devices". Say 'y', of course, then say 'y' to 
  95.    SLIP and TCP/IP, (Tia 2.0 users: say 'y' to CSLIP instead/also) and 'n' 
  96.    to everything else, unless you have ethercards or need some other 
  97.    protocol for something else. If you don't do this, it won't work! Finish 
  98.    compiling and installing the new kernel, then,
  99.  
  100.    2.2 Edit some files in /etc
  101.  
  102.    These files will set up your routes to your remote host. /etc is the 
  103.    directory for system configurations. Replace everything in double 
  104.    quotes with the appropriate values, naturally (but don't include the 
  105.    quotes - they are there for reference). There are three files you need to 
  106.    edit, they are:
  107.  
  108.       /etc/hosts: 
  109.  
  110.    127.0.0.1       localhost
  111.    127.0.0.1       "your.hostname.domain"
  112.    "XXX.XXX.XX.XX" "remote.hostname.domain remote"  #<-- Note the abbreviation.
  113.               
  114.  
  115.       /etc/host.conf: 
  116.  
  117.       order hosts, bind
  118.       multi on
  119.               
  120.  
  121.       /etc/resolv.conf: 
  122.  
  123.       domain "yourdomainhere"         
  124.       nameserver "XXX.XXX.XX.XX"      #<- Usually the same as in /etc/hosts
  125.               
  126.  
  127.       To use an NNTPserver, put this line in your /etc/profile:
  128.  
  129.       export NNTPSERVER="remote.hosts.nntpservername"
  130.  
  131.    2.3 Dip
  132.  
  133.    Dip is what you will use to dial up the remote host, start TIA, and 
  134.    convert the line to SLIP. It comes in the "N" set of Slackware, along with 
  135.    a bunch of clients and utilities, some of which you may want to install 
  136.    also =). It is also available at Sunsite in an individual tar file
  137.  
  138.    Once you have it installed, you will need to have a dip script, Here's a 
  139.    sample, just plug in the appropriate stuff where the double quotes are 
  140.    (but don't include the quotes, they are there for reference).
  141.  
  142. ----------CUT HERE--------------------------------
  143.  
  144. main:
  145.   get $local "your.hostname.domain"
  146.   get $remote "remote.hostname.domain"
  147.   port cua"?"                   #<-- Your port here
  148.   speed 38400                   #<--You may be able to use 57400 in newer 
  149.   reset                         # kernels
  150.   init AT "string of commands"
  151.   wait OK 5
  152.  
  153. # This will redial. If it doesn't work, play with the wait time (listen 
  154. # to your modem). If it still doesn't work, mail me.
  155. # See also; the note at the bottom of the script re: error codes.
  156.  
  157. dial:
  158.   dial "phonenumber"
  159.   print Dialing...
  160.   if $errlvl != 0 goto error
  161.   wait BUSY 20                  #<--You may need to change this wait time  
  162.   if $errlvl == 0 goto dial     #   to suit your modem
  163.  
  164. login:
  165.   print Connected and Logging in...
  166.   wait ==> 60                   #<-- This wait and send get me past my 
  167.   send 4\n                      #<-- hosts Annex. Change for your site!
  168.   wait ogin: 60
  169.   if $errlvl != 0 goto login_error1
  170.   send "LOGIN"\n
  171.   wait assword: 60
  172.   if $errlvl != 0 goto login_error2
  173.   send "PASSWORD"\n
  174.  
  175. loggedin:
  176.   wait "SYSTEM PROMPT" 60
  177.   if $errlvl != 0 goto shell_error
  178.   send tia\n
  179.   wait software. 60
  180. # TIA 2.0 users: Change the above line to read
  181. # wait now) 60
  182.   if $errlvl != 0 goto tia_error
  183.   print Starting TIA...
  184.   get $mtu 296          #<--Tia recommends 1500, but this is faster 
  185.   default               #interactively. Ftp will be slower, so adjust to taste.
  186.  
  187. done:
  188.   print CONNECTED to $remote with address $rmtip
  189.   mode SLIP
  190. # TIA 2.0 users: change the above line to 
  191. # mode CSLIP
  192.   goto exit
  193.  
  194. error:
  195.   print Dialing Error
  196.  
  197. login_error1:
  198.   print No Login
  199.  
  200. login_error2:
  201.   print No Password prompt
  202.  
  203. shell_error:
  204.   print No shell prompt
  205.  
  206. tia_error:
  207.   There was a problem starting TIA
  208.  
  209. exit:
  210.   \r            #<--This will error out with the -v flag, but work when 
  211.                 #run normally (ends dip at a local prompt).
  212.  
  213. -------------CUT HERE-----------------------------
  214.  
  215. Newer versions of dip don't return modem status codes (BUSY, NO CONNECT, etc.),
  216. they use numbers instead. Here's a table:
  217.  
  218.    0 = OK 
  219.    1 = CONNECT 
  220.    2 = ERROR 
  221.    3 = BUSY 
  222.    4 = NO CARRIER
  223.  
  224. This would make your dial section look like this:
  225.  
  226. dial:
  227.   dial "phonenumber"
  228.   print Dialing...
  229.   if $errlvl != 0 goto error
  230.   wait 1 20     
  231.   if $errlvl != 1 goto dial
  232.  
  233. Thanks to Lee Olds (lee@eskimo.com) for that bit. 
  234.  
  235. \n = newline, \r = carriage return. You may require one or the other (or 
  236. both) in the appropriate places. If the ones provided don't work, experiment.
  237.  
  238. After editing this file, rename it, say, remote.dip and put it in /root. 
  239. Then, as root, run 'dip remote'. Use the -v flag the first time to debug
  240. it ('dip -v remote'), this will show you all the steps dip takes. 
  241.  
  242. Dip will only run as root, but there is a way to make it run from a user
  243. account. For now, if you need this info, ask. I may include it in this
  244. file later if enough people want it. 
  245.  
  246. If dip errors out right away, try removing the comments from the script.
  247.  
  248.  
  249.  
  250.    3.0 Now what?
  251.  
  252.    Hey, if all went well, you are now connected to the Net! Try a 'telnet 
  253.    remote' (remember that abbreviation in your hosts file?). You should get 
  254.    the remotes telnet login prompt. Go on, try it! You can now telnet/FTP/etc.
  255.    anywhere on the Net from your local machine. How? Your machine is using 
  256.    the remote as a nameserver to resolve addresses (resolv.conf). Experiment, 
  257.    find out what works and what doesn't.
  258.  
  259.    You will not be able to use services that are not provided already on your
  260.    remote host! For example, if your server doesn't allow telnets, chances 
  261.    are you can't do it either. Why? Because TIA is only re-directing what 
  262.    is already available.
  263.  
  264.    3.1 News and Mail
  265.  
  266.    This probably requires another HOWTO. 
  267.  
  268.    However, two quickies: If you set your NNTPserver to your remote hosts
  269.    NNTP server in /etc/profile, the trn binary will work to READ the News
  270.    without modification (but not post. I haven't had time to play with this. If
  271.    you've gotten it to work, by whatever means, I'd appreciate the input for
  272.    another HOWTO).
  273.  
  274.    If you've installed the s(end)mail binary, pine will work normally LOCALLY
  275.    (on your own machine between accounts), but only SEND mail to the Net (once
  276.    again, the shortage of time. And again, input appreciated).
  277.  
  278.    ***UPDATE: On Sunsite, in /pub/Linux/system/Mail/pop, there are some tools
  279.    for utilizing a POP server (such as Eskimos) to retrieve mail. If anyone 
  280.    wants to try these before I get to them, let me know how it works. 
  281.  
  282.    3.2 Mosaic/Netscape
  283.  
  284.    Obviously, you will need to have X running for this to work, but it's a 
  285.    simple matter of FTPing the binary, unpacking it, and installing it. 
  286.  
  287.    3.3 Remote X
  288.  
  289.    You can run remote X applications via TIA. Look for my TIA-Linux.HOWTO at 
  290.    http://www.eskimo.com/~irish, or at ftp.eskimo.com in /u/i/irish
  291.  
  292.  
  293.    4.0 Misc.
  294.  
  295.    If I've left anything out, or you still have questions, I read my mail 
  296.    daily. This will probably get updated quickly at first, so keep checking 
  297.    for more info (I'll change the version numbers). Naturally, the more you 
  298.    contribute, the more info will be included here, so don't hesitate to 
  299.    tell me about whatever you have to offer.
  300.  
  301.    If you would like some help, or are having trouble with your setup, 
  302.    I'll help but you must send me the following info: 1. A copy of your 
  303.    three /etc files. 2. A copy of your script output, run with the -v flag 
  304.    (please remove your password from this!)
  305.  
  306.    Even if you don't have anything, but used this info sucsessfully, PLEASE MAIL
  307.    ME. I want to know how useful this really is.
  308.  
  309.    4.1 References
  310.  
  311.    Sunsite is the FTP site sunsite.unc.edu, a veritable plethora of everything
  312.    Linux, including almost every FAQ, HOWTO, and README written.
  313.  
  314.    Marketplace.com is the home of TIA, the only place it is available.
  315.  
  316.    I am Irish, irish@eskimo.com, available for comment on Linux almost
  317.    everyday, when I'm not petting my cat or hugging my kid.
  318.  
  319.